package com.example.userdepartment.service;

import com.example.userdepartment.entity.User;
import com.example.userdepartment.util.Result;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 用户服务接口
 */
public interface UserService {
    
    /**
     * 查询所有用户
     *
     * @return 用户列表
     */
    List<User> findAll();
    
    /**
     * 根据ID查询用户
     *
     * @param id 用户ID
     * @return 用户信息
     */
    User findById(Integer id);
    
    /**
     * 根据用户ID查询用户及部门信息
     *
     * @param id 用户ID
     * @return 包含部门信息的用户
     */
    User findWithDeptById(Integer id);
    
    /**
     * 添加用户
     *
     * @param user 用户信息
     * @return 添加后的用户
     */
    User add(User user);
    
    /**
     * 更新用户
     *
     * @param user 用户信息
     * @return 更新后的用户
     */
    User update(User user);
    
    /**
     * 删除用户
     *
     * @param id 用户ID
     * @return 是否删除成功
     */
    boolean delete(Integer id);
    
    /**
     * 批量删除用户
     *
     * @param ids 用户ID列表
     * @return 是否删除成功
     */
    boolean batchDelete(List<Integer> ids);
    
    /**
     * 根据部门ID查询用户列表
     *
     * @param departmentId 部门ID
     * @return 用户列表
     */
    List<User> findByDepartmentId(Integer departmentId);
    
    /**
     * 搜索用户
     *
     * @param keyword 关键字（用户名、姓名、邮箱、手机号）
     * @param departmentId 部门ID
     * @return 用户列表
     */
    List<User> searchUsers(String keyword, Integer departmentId);
    
    /**
     * 导入用户
     * 
     * @param file Excel文件
     * @return 导入结果
     */
    Result importUsers(MultipartFile file);
    
    /**
     * 导出用户数据到Excel
     *
     * @return Excel文件字节数组
     */
    byte[] exportUsers();
} 